home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_3 / phoon / readme.amiga < prev   
Text File  |  1994-02-24  |  4KB  |  91 lines
  1.  
  2. phoon - program to show the current phase of the moon on the
  3.     Amiga display. ported from the X11 program xphoon.
  4.  
  5.     I ported this program so I can enjoy the same background picture as I have
  6.     On the Xterminals I use. I release this so you all can also enjoy it.
  7.  
  8.     My part of the program is entirely free. Read other copyright notices from
  9.     libs and src directories.
  10.  
  11.     And DISCLAIMER: use this program at your own risk. This software is 
  12.     provided "as is" without express or implied warranty.
  13.  
  14.     To run this program you need iff.library version 23.x located in your
  15.     libs: -directory and one of the fullmoon pictures (from fullmoons
  16.     directory in this distribution, names tell the x and y -radiuses of the
  17.     fullmoon pictures).  Default path for fullmoon picture is "fullmoon.ilbm"
  18.     on current working directory, but that can be changed by binarypatching
  19.     the "phoon" or by giving a new path at command line.
  20.  
  21.     Program outputs the phoon picture to ram:phoon.pic -file.
  22.  
  23.     Usage for this program is:
  24.  
  25.     phoon -f=FILE,-g=POSITION/K,-d=DOUBLE/S,-s=SHADE/S,
  26.         -r=REVERSE/S,-h=GMTOFFSET/N
  27.  
  28.     -s :shades the shadowed part of the moon w/ calculated approximate
  29.         earthlighting, without this flag the area becomes completely
  30.         black.
  31.  
  32.     -d :this flag douples every bit in shading pattern. If one's monitor
  33.         can't show single bits well, I have included fullmoon pictures
  34.         whose bits are doubled too (d504x252.ilbm and d504x189.ilbm)
  35.  
  36.     -f filename :path and filename of the fullmoon picture you want to use
  37.         default filename is "fullmoon.ilbm" and it can also be 
  38.         binarypatched to any name, max approximately 50 chars long. 
  39.  
  40.     -g dcx[dcy[drx[dry]]] :there are fullmoon pictures of different sizes.
  41.          this program gets the center and radius of the picture depending
  42.          on the size ratios between original (1600x1280) and the used
  43.          fullmoon picture. the ratio between bigfullmoon and fullmoon 
  44.              radius and center is not always same (or there is a bug in 
  45.          calculations). This option changes the center and radius of the
  46.          moon picture. For example -g +1-5+6 moves center one left and 5 
  47.              up, increasing x-radius by 6.
  48.          Now i have noticed, that all fullmoons get shadowed correctly,
  49.          but there might be need for this option anyway (at least it is
  50.          fun to play w/ it)
  51.  
  52.     -r this option reverses black and white color.
  53.  
  54.     -h Since phase calculations need GMT time and Amiga uses local time
  55.          phoon tries to obtain time zone infromation from locale. If it is
  56.          not available or you want to overrun locale definition give
  57.          timezone offset as hours from GMT. Use positive values for 
  58.          timezones east from GMT (middle and easter europe and russia) and
  59.          negative for American countries etc.
  60.  
  61.     How to put fullmoon picture on the workbench background:
  62.  
  63.     add NickPrefs to your s:startup-sequence just after IPrefs (read
  64.     NickPrefs documentation about it)
  65.  
  66.     copy envars_sys/phoon_wbpic.prefs to your envarc:sys directory
  67.  
  68.     write these lines in start of your s:user-startup:
  69.  
  70.        phoon (options you might need)
  71.        Rename env:sys/phoon_wbpic.prefs env:sys/wbpicture.prefs
  72.  
  73.     and to end of your s:user-startup
  74.  
  75.        Delete ram:phoon.ilbm
  76.  
  77.     fullmoon pictures are made the following way: (in unix w/ pbmplus)
  78.  
  79.     xbmtopbm bigfullmoon.xbm | pnmscale .6666 | pgmtopbm | pbmtoilbm >504x504.ilbm
  80.     xbmtopbm bigfullmoon.xbm | pnmscale -xscale .3333 -yscale .25 | pgmtopbm | p4doublepixel | pbmtoilbm >d504x189.ilbm
  81.     ...
  82.  
  83.     Have fun
  84.  
  85. Tomi Ollila
  86. too@cs.hut.fi
  87. Kitarakuja 1 A 266
  88. 00420 Helsinki
  89. Finland
  90. -358-0-563-5733
  91.